home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 001 / uucoder / !UUcoder_!Help < prev    next >
Encoding:
Text File  |  1994-11-16  |  5.6 KB  |  157 lines
  1. UUcoder 1.00
  2. ============
  3.  
  4.  
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6. + ⌐ John Allen 1994.  This application is Freeware and is           +
  7. + supplied on the understanding that:                               +
  8. +                                                                   +
  9. + 1. The source code is not altered in any way                      + 
  10. + 2. Any copies made contain all of the files in the directory      + 
  11. + 3. It is not sold for a profit                                    + 
  12. +                                                                   + 
  13. + Please contact me before adding it to a PD library so that I can  + 
  14. + supply an up to date version.                                     + 
  15. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  16.  
  17.  
  18. !UUcoder codes and decodes uuencoded files such as might be sent and 
  19. received via Usenet newsgroups on the Internet.  
  20.  
  21. !UUcoder works totally on the RISC OS desktop.  It is a development of 
  22. my !uuCombine utility, but adds the ability to encode files and has 
  23. been completely rewritten.
  24.  
  25. As well as decoding single files it will also turn a series of messages 
  26. containing sections of a uu encoded file (such as might be found in 
  27. newsgroups with'binaries' in the title) into a single decoded file.  
  28.  
  29. Version 1.00 has been tested with !TTFN and Demon.  It may work 
  30. perfectly with other readers and services and I would like feedback on 
  31. that.  It is designed to work only under RISC OS 3.10 and later 
  32. versions.
  33.  
  34. !UUcoder saves and loads files to and from !Scrap so will run much 
  35. better on a machine with a hard disc, but then Internet (or at least 
  36. Demon) would be a pain on a machine which only had floppy drives.
  37.  
  38. The following files should be included in the !UUcoder directory:
  39.  
  40. !Boot
  41. !Help
  42. !Run
  43. !RunImage
  44. !Sprites
  45. Templates
  46.  
  47.  
  48. Use 
  49. ===
  50.  
  51. Double click on the !UUcoder icon in the Filer window.  This installs 
  52. !UUCoder on the iconbar and opens the coding and decoding window.
  53.  
  54. To encode a file:
  55.  
  56. 1. Drag the file you wish to encode to the code icon at the top right 
  57. of the window.  If you are sending the file to someone with a PC rather 
  58. than an Arc you should rename the file with the appropriate file PC 
  59. file extension, using a "/" instead of a ".".  This ensures that the PC 
  60. user gets a correctly typed file when they decode it.  For example a 
  61. gif file "mum" should be called "mum/gif" which will be coded with the 
  62. PC file name of "mum.gif".
  63.  
  64. 2. !UUcoder will encode the file.
  65.  
  66. 3. Edit the default file name of "File_uue" to the name you wish to 
  67. save under and drag the file icon to a Filer window or another 
  68. application.  Alternatively enter the full path name and click 'OK'.
  69.  
  70.  
  71. To decode a file or series of files:
  72.  
  73. 1. Drag a uuencoded file to the decode icon at the bottom right of the 
  74. window.  !UUcoder will detect whether it is a complete coded file or 
  75. give a prompt for the next file in a series.  Continue dragging the 
  76. series of files to the icon until !UUcoder detects the last file.  The 
  77. files must be dragged in order.
  78.  
  79. 2. !UUcoder decodes the complete uuencoded file.
  80.  
  81. 3. Edit the supplied name as appropriate, then drag the file icon to a 
  82. Filer window or another application.  Alternatively enter the full path 
  83. name of the file and click on the 'OK' icon.
  84.  
  85.  
  86. Features
  87. ========
  88.  
  89. * !UUcoder will accept files direct from other applications so, for 
  90. example, if you use !TTFN you can use the 'Save File' option to 
  91. directly input files by dragging them to the decoder window rather than 
  92. saving them to the Filer first.
  93.  
  94. * !UUcoder uses solid sprite dragging if you have it enabled on your 
  95. machine.
  96.  
  97. * !UUcoder will translate PC file extensions to RISC OS filetypes as 
  98. follows:
  99.  
  100.           PC           RISC OS
  101.  
  102.          .arc           &DDC
  103.          .gif           &695
  104.          .jpg           &C85
  105.          .mpg           &BF8
  106.          .tif           &FF0
  107.          .txt           &FFF
  108.          .uue           &FFF
  109.          .zip           &DDC
  110.  
  111. This means that the output files can be double clicked to load them 
  112. into image translators such as !ChangeFSI, !Translatr or !FYEO2 (.jpg, 
  113. .gif and tif), an MPEG viewer (.mpg) or de-archiver such as !Spark 
  114. (.arc and .zip).
  115.  
  116. I would welcome suggests of other file extensions which could be 
  117. translated to RISC OS filetypes (and appropriate sprites) in this way.
  118.  
  119. * !UUcoder will also transfer directly to and from other applications 
  120. which accept direct transfer.  Note that there is a bug in !Translatr 
  121. which means it will not accept .jpg files unless you edit one line in 
  122. !Translatr's !Run file.  The line that reads: 
  123.  
  124.           "Set Translator$Scrap <Wimp$Scrap>" 
  125.  
  126. should be changed to point to a different file such as: 
  127.  
  128.           "Set Translator$Scrap <Wimp$Scrap>2" 
  129.  
  130. * Closing the decode window part way through building up a file to 
  131. decode will destroy the partly completed file (as per Acorn's 
  132. guidelines).  To continue building the file hold the shift key down 
  133. when closing the window so that the window is iconised on the pinboard 
  134. and can be reopened.
  135.  
  136.  
  137. Background
  138. ==========
  139.  
  140. UUcoded files are put on the Internet in a wide range of forms.  This 
  141. means that it is not always easy to detect the start and end of 
  142. sections of code which need to be combined before decoding.  !UUcoder 
  143. makes intelligent guesses but I would welcome examples of files where 
  144. it does not produce a valid output file.  In cases of doubt you can 
  145. edit 'END' as the line after the last coded line of a file, this 
  146. clearly signifies to !UUcoder that it has reached the end of a section.
  147.  
  148.  
  149.  
  150. Any comments, queries, donations or bug reports to:
  151.  
  152. John Allen
  153.  
  154. E-mail: john@bramber.demon.co.uk
  155. Arcade: #917
  156. Silicon Village: 819991215
  157.